home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / dgebak.z / dgebak
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))                                                          DDDDGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DGEBAK - form the right or left eigenvectors of a real general matrix by
  10.      backward transformation on the computed eigenvectors of the balanced
  11.      matrix output by DGEBAL
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE DGEBAK( JOB, SIDE, N, ILO, IHI, SCALE, M, V, LDV, INFO )
  15.  
  16.          CHARACTER      JOB, SIDE
  17.  
  18.          INTEGER        IHI, ILO, INFO, LDV, M, N
  19.  
  20.          DOUBLE         PRECISION SCALE( * ), V( LDV, * )
  21.  
  22. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  23.      DGEBAK forms the right or left eigenvectors of a real general matrix by
  24.      backward transformation on the computed eigenvectors of the balanced
  25.      matrix output by DGEBAL.
  26.  
  27.  
  28. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.      JOB     (input) CHARACTER*1
  30.              Specifies the type of backward transformation required:  = 'N',
  31.              do nothing, return immediately; = 'P', do backward transformation
  32.              for permutation only; = 'S', do backward transformation for
  33.              scaling only; = 'B', do backward transformations for both
  34.              permutation and scaling.  JOB must be the same as the argument
  35.              JOB supplied to DGEBAL.
  36.  
  37.      SIDE    (input) CHARACTER*1
  38.              = 'R':  V contains right eigenvectors;
  39.              = 'L':  V contains left eigenvectors.
  40.  
  41.      N       (input) INTEGER
  42.              The number of rows of the matrix V.  N >= 0.
  43.  
  44.      ILO     (input) INTEGER
  45.              IHI     (input) INTEGER The integers ILO and IHI determined by
  46.              DGEBAL.  1 <= ILO <= IHI <= N, if N > 0; ILO=1 and IHI=0, if N=0.
  47.  
  48.      SCALE   (input) DOUBLE PRECISION array, dimension (N)
  49.              Details of the permutation and scaling factors, as returned by
  50.              DGEBAL.
  51.  
  52.      M       (input) INTEGER
  53.              The number of columns of the matrix V.  M >= 0.
  54.  
  55.      V       (input/output) DOUBLE PRECISION array, dimension (LDV,M)
  56.              On entry, the matrix of right or left eigenvectors to be
  57.              transformed, as returned by DHSEIN or DTREVC.  On exit, V is
  58.              overwritten by the transformed eigenvectors.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))                                                          DDDDGGGGEEEEBBBBAAAAKKKK((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      LDV     (input) INTEGER
  75.              The leading dimension of the array V. LDV >= max(1,N).
  76.  
  77.      INFO    (output) INTEGER
  78.              = 0:  successful exit
  79.              < 0:  if INFO = -i, the i-th argument had an illegal value.
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.